home *** CD-ROM | disk | FTP | other *** search
/ Turnbull China Bikeride / Turnbull China Bikeride - Disc 1.iso / ARGONET / PD / FILER / VZAP133 / !VZap / Docs / Manual < prev    next >
Text File  |  1997-12-29  |  17KB  |  317 lines
  1. ****************************************************************************
  2. *      VZAP - PROBABLY THE BEST ARCHIMEDES VIRUS CHECKER IN THE WORLD      *
  3. ****************************************************************************
  4.                             © 1994/5/6 Paul Vigay
  5.  
  6.  
  7.                     DETAILED INSTRUCTIONS FOR USING !VZAP
  8.                     ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  9.  
  10.  
  11. INSTRUCTIONS
  12. ~~~~~~~~~~~~
  13. !VZap is quite self-explanatory and easy to use. It also supports Acorn's 
  14. interactive help application.
  15.  
  16. However, there now follows a brief run down of it's usage and various 
  17. options. In addition, full support is provided for Acorn's Interactive !Help 
  18. application.
  19.  
  20. Before using !VZap, it is best to make a backup copy and store this safe 
  21. somewhere in case you should need to re-install it.
  22.  
  23.  
  24. MAIN MENU: (obtained by pressing MENU, the middle mouse button, from the icon bar)
  25. ~~~~~~~~~~
  26.            Info       Gives information and version number.
  27.  
  28.            Kill Task  Allows access to a sub-menu containing up to the last 
  29.                       ten tasks loaded. Clicking on a specific task will 
  30.                       'Quit' it.
  31.                       This is handy, especially if unknown 'suspicious 
  32.                       looking' tasks suddenly load for no apparent reason.
  33.  
  34.            Choices... Opens the 'Choices' window (details below)
  35.  
  36.            Quit       Quit !VZap and remove from the icon bar.
  37.            
  38. THE CHOICES WINDOW:
  39. ~~~~~~~~~~~~~~~~~~~
  40. For ease of use, only half of the choices window is visible when you select 
  41. this option from the main menu. To toggle full size, click SELECT on the top 
  42. right (toggle size) icon on the window pane.
  43.  
  44. Initially, the following options are available:
  45.  
  46. AutoScan:
  47. ---------
  48.     Scan floppies     If on, !VZap will automatically scan floppy discs for
  49.                       viruses as soon as you click upon the drive icon on the
  50.                       icon bar. After you've scanned all your floppies, which
  51.                       may become a bit tedious, hence the ability to turn it on
  52.                       and off.
  53.                       N.B. This facility will temporarily override the 
  54.                       'AutoZap' feature and turn it ON, irrespective of it's 
  55.                       normal setting.
  56.                       It will return to it's previous value as soon as the 
  57.                       scan has been completed.
  58.  
  59.     On startup:       Entering a directory filepath into the blank box will tell
  60.                       !VZap to automatically scan any specified directory next time
  61.                       !VZap is loaded (assuming you save the options - see below).
  62.                       You must specify the FULL pathname of the directory you wish
  63.                       to scan. ie. entering 
  64.                                                ADFS::HardDisc4.$.Applicats
  65.                       will scan the directory called 'Applicats' in the root
  66.                       directory of HardDisc4.
  67.                       N.B. You can drag a specific directory into the choices window
  68.                       in order to save typing the full filepath, if required.
  69.                       To cancel, simply ensure that this icon is empty.
  70.  
  71.  
  72. Virus Scan:
  73. -----------
  74.     Wimp watch        If on, !VZap will bleep each time a new task or application
  75.                       loads, and will also keep an eye on the wimp environment,
  76.                       informing you of any changes or alterations that occur.
  77.  
  78.     Autozap           If on, !VZap will automatically deal with known viruses when
  79.                       it is doing a disc scan. This is handy if you are a novice
  80.                       user, or simply want viruses removed with no user
  81.                       intervention.
  82.                       HOWEVER. If this is on, ONLY VERIFIED viruses are dealt with.
  83.                       If off, !VZap will pick up any files that simply 'look
  84.                       suspicious' thereby possibly detecting any as yet
  85.                       undiscovered viruses. It is best to keep this option on
  86.                       unless you are aware of how to examine !Boot files using
  87.                       !Edit.
  88.                       (see also 'On startup' above)
  89.  
  90.     *Set              Again, this option is for the more technically minded and
  91.                       allows a more thorough search of files.
  92.                       This will pick up any attempts to *SET an alias and then
  93.                       load a virus by calling the alias. It is inevitable that
  94.                       when this option is on, many false alarms may be given.
  95.                       Unless you know how to interpret !Boot files in detail,
  96.                       then leave this option off.
  97.                       N.B. If autozap is on, ONLY verified viruses will actually
  98.                       be eliminated, so you don't need to worry about the 
  99.                       increased 'sensitivity' of this option, deleting important
  100.                       files.
  101.  
  102.  
  103.     Stamp             If on, !VZap will save a short text file to the disc just
  104.                       scanned, informing future users that it is free from
  105.                       viruses known to whichever version of !VZap you are using.
  106.  
  107.     Auto Quit         If on, !VZap will Quit automatically as soon as a virus
  108.                       scan has been carried out. This can be useful if used in
  109.                       conjunction with 'On startup' (described above) as it will
  110.                       free the memory occupied by !VZap as soon as a virus scan
  111.                       is complete.
  112.                       NOTE: Should you wish to override this feature once it has
  113.                       been set, hold the 'Q' key down when you load !VZap. This
  114.                       will set it to 'off' but will NOT change the permanent
  115.                       setting, saved on disc. To do this you will need to 'Save'
  116.                       the choices again.
  117.  
  118.  
  119. Logging:
  120. --------
  121.     Disc log          If on, !VZap will write a text file to disc containing
  122.                       any relevant comments whilst it does it's virus scan.
  123.                       The file is automatically created inside the directory
  124.                       called DirLog, inside !VZap itself, and is called LogFile.
  125.                       This option is especially useful when used in conjunction
  126.                       with 'Autozap'.
  127.  
  128.     Auto Reset        If on, this will ensure that the log file is deleted each
  129.                       time !VZap is loaded. This means that the log file only
  130.                       contains information relevant to the scans you've carried
  131.                       out during the present session. If the option is off, the
  132.                       log file will simply be appended each time you run !VZap
  133.                       so a continuous log may be kept. Obviously, depending 
  134.                       upon how many times you carry out a virus scan, this file
  135.                       may become quite long.
  136.                       
  137.     Log path          Contains the name of the log file. By default, it is called
  138.                       "Logfile" and stored within the !VZap directory itself. This
  139.                       file should not be deleted (even if the filename is moved
  140.                       elsewhere) or !VZap will fail to install correctly. You can
  141.                       drag the icon into a new directory window to set the full
  142.                       filepath to a different directory. This option is saved with
  143.                       the choices, so be careful if you move !VZap to another
  144.                       computer.
  145.                       N.B. Be careful if you decide to store the logfile within
  146.                       !VZap itself, as VZap does it's own verification and will
  147.                       not like more than a single (text) logfile within it's own
  148.                       directory. If you change the filename from the default
  149.                       "Logfile", ensure you delete any previous log files.
  150.  
  151.  
  152. Activating Choices:
  153. -------------------
  154.     Default           Clicking on this icon will restore all the above options
  155.                       to their preset 'factory' settings. Well, the ones I've
  156.                       programmed in actually!
  157.  
  158.     Save              Clicking on this icon will save the settings in the choices
  159.                       window to disc so that you don't have to reset them next
  160.                       time you load !VZap.
  161.  
  162.     Cancel            This will cancel any changes you have just made and restore
  163.                       any previous settings set before you called up the Choices
  164.                       window.
  165.  
  166.     OK                This will any changes you may have made for the current
  167.                       session only, and NOT save them to disc for future use.
  168.  
  169.  
  170. Options on the right-hand side of the Choices window:
  171. -----------------------------------------------------
  172.     Filer             Clicking SELECT or MENU lets you change the filing system
  173.                       from any recognised ones available on your computer.
  174.  
  175.     Drive             Clicking SELECT or MENU lets you change the drive to scan
  176.                       (from 0 to 7)
  177.  
  178. Due to popular demand the 'Filer' and 'Drive' settings are duplicated within the
  179. main status window. This is so that you don't have to keep opening the Choices
  180. window if you are scanning lots of different filing systems and drive numbers.
  181.  
  182.     Sound             Toggles on and off the sound. This is useful when using in
  183.                       a classroom environment where the bleeps may become
  184.                       irritating.
  185.  
  186.     Scan memory now   Performs a quick check on the memory inside the computer.
  187.                       If the main status window is open, a status report will be
  188.                       given.
  189.                       If a virus is present, the status window will open
  190.                       automatically and give you the option to deal with the
  191.                       virus.
  192.  
  193.                    
  194. ADDITIONAL NOTES
  195. ~~~~~~~~~~~~~~~~
  196. Stopping a virus scan
  197.                A complete virus scan make take a little while, especially if you
  198.                have many hundred (thousand?) files on a hard disc. The actual
  199.                virus scan itself is non-multi-tasking. This is deliberate, so
  200.                that devious viruses cannot re-infect files already inoculated.
  201.                However, if you decide you wish to abort the virus scan part way
  202.                through, you can press ESCAPE at any time to stop the scan.
  203.  
  204. Scanning specific directories/files:
  205.                Individual directories and/or files can be scanned by SELECTing 
  206.                the required file icons and dragging into either the !VZap icon
  207.                (on the icon bar) or into the main status window.
  208.                Multiple directories can be dragged, simply by dragging a group
  209.                of files/directories onto the !VZap iron or the main status
  210.                window.
  211.                If !SparkFS is loaded, the contents of archives will also be
  212.                scanned when using this facility.
  213.                Files compressed using Computer Concept's CFS filing system are
  214.                automatically scanned if !VZap detects the presence of CFS.
  215.                
  216. What's actually scanned for?
  217.                The main way that viruses can spread via the Archimedes RISC OS
  218.                system is via !Boot files within applications, because these are
  219.                executed as soon as the user opens their parent directory. !VZap
  220.                will scan ALL !Boot files. 
  221.                The second way a virus can creep in is via a !Run file. These are
  222.                only executed when a user double-clicks on an application to
  223.                load it, but are nonetheless as easy to infect as !Boot files.
  224.                !VZap also scans all !Run files.
  225.                !VZap also scans module files, which can sometimes become infected.
  226.                Lastly, !VZap can actually scan any filetypes it thinks may
  227.                become infected with a virus, especially if the interrogation of
  228.                other files indicates a hidden file somewhere.
  229.                Generally, data files such as Sprite and !Draw files are virus
  230.                resistant. However, !VZap believes it is better to be safe than
  231.                sorry and is equally capable of scanning any type of file it
  232.                considers to be 'suspicious'.
  233.  
  234. !Boot files
  235.                Most viruses affect !Boot files by adding lines to the end
  236.                of them, to load the virus program itself. !VZap will
  237.                detect this and give the option to INOCULATE the virus. If
  238.                this option is given, !VZap will delete the appended
  239.                lines and restore the !Boot file to it's original condition.
  240.  
  241.                However, occasionally you may find that !VZap finds one
  242.                or more SUSPICIOUS lines in a !Boot file. If this is the case
  243.                !VZap gives you the option to 'comment' the suspect lines.
  244.                If you choose to comment the relevant lines, !VZap will
  245.                insert a | character at the beginning of the suspect line so
  246.                that it is not executed in future. You can examine the
  247.                file later (using a text editor) and check which lines
  248.                have been commented.
  249.  
  250.                N.B. If your expertise does not extend to examining !Boot 
  251.                files, you are always welcome to sent any suspicious files
  252.                to me (on an 800K E format disc please), enclosing a stamped
  253.                addressed envelope for reply and telling me which version of
  254.                !VZap you are using (see 'Info' option). I will then check the
  255.                file(s) for you and return your disc ASAP. This service is
  256.                completely free of charge (as long as you send a disc and
  257.                SAE), but unfortunately, is only available to registered users.
  258.                
  259. Locked files
  260.                If !VZap finds a locked file, it will unlock it and deal with
  261.                it if it contains a potential virus, otherwise it's protection
  262.                status will be left unaltered if the file is harmless. Thus
  263.                !VZap can delete viruses even though they may be locked against
  264.                deletion.
  265.                
  266. Protected discs
  267.                Obviously there's not a lot !VZap can do if it finds a virus on
  268.                a protected disc, as it physically cannot write back to the disc.
  269.                In such an event an error will be given and you should un write-
  270.                protect the disc and try again.
  271.  
  272. Broken directories
  273.                !VZap is unaffected by Broken directories, simply
  274.                skipping over the corrupted file(s). However, one side
  275.                affect of this is that RISC OS is unable to calculate how 
  276.                many files are on the disc, hence the hourglass may be
  277.                inaccurate.
  278.                
  279. Disc Errors
  280.                !VZap does not abort it's virus scan if a disc error is
  281.                encountered. It simply skips over the corrupted file and
  282.                continues scanning past the disc error.
  283.                Users of Disc Commander should be able to restore most
  284.                disc errors without too much trouble, recovering lost data.
  285.                (read the file called 'Advert' for more information)
  286.  
  287. Virus infection
  288.                In case a virus has already loaded before you load !VZap
  289.                and it's one that !VZap doesn't spot when it does it's
  290.                self-check, it's always best to perform a CTRL-BREAK, both
  291.                before AND after using !VZap.
  292.                                    
  293.    
  294. Comment from the Author !
  295. ~~~~~~~~~~~~~~~~~~~~~~~~~
  296. I have received a number of comments about compiling !VZap and not 
  297. releasing the source code. I have this to say;
  298. I have decided to protect !VZap by compiling it, for two reasons;
  299.  
  300. 1. By not seeing how I have detected and killed viruses, virus writers won't
  301.    get any ideas on how to amend viruses to avoid detection and be able to
  302.    make more devious viruses in the future.
  303.  
  304. 2. By not supplying the source code, it makes it extremely difficult for
  305.    any potential hackers and virus writers to amend my code and/or 
  306.    incorporate viruses into the !VZap code itself.
  307.    !VZap incorporates fairly extensive self testing to ensure that the
  308.    !VZap application itself is safe from contamination. Therefore, do
  309.    not attempt to alter any files within the !VZap application, or it
  310.    may fail to load correctly.
  311.  
  312. ©1994/5/6 Paul Vigay
  313.  
  314. P.S. Please feel free to call my Bulletin Board on (01705) 871531
  315. for latest news concerning !VZap. All downloads on this BBS are
  316. guaranteed virus free.
  317.